home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload Trio 2 / Shareware Overload Trio Volume 2 (Chestnut CD-ROM).ISO / dir24 / frenchgp.zip / BYR31.ZIP / BYR.DOC < prev    next >
Text File  |  1994-08-14  |  29KB  |  666 lines
  1.  
  2. BYR version 3.1: fichier de documentation.
  3. ==========================================
  4.  
  5. *************************************************************
  6. * LISEZ ENTIEREMENT LES DOCUMENTATIONS, SINON VOUS PASSEREZ *
  7. *      A COTE DE FONCTIONS SOUVENT TRES INTERESSANTES       *
  8. *************************************************************
  9.  
  10.  
  11. I. Introduction
  12. ---------------
  13.  
  14. BYR est un programme qui permet à tout terminal utilisant TFPCX (GP, TOP, ...)
  15. d'émettre et de recevoir des fichiers en mode YAPP (incluant la reprise de
  16. transfert et le YAPPC) et de récupérer automatiquement plusieurs fichiers dans
  17. le DOS d'un BBS FBB.
  18. Il permet aussi de répondre automatiquement au mot de passe d'un BBS type FBB.
  19. Il inclut maintenant un gestionnaire de macro qui rend possible
  20. l'automatisation de toutes les manipulations courantes en packet.
  21. Enfin, il rend possible la lecture de messages en mode compacté sur BBS FBB.
  22.  
  23.  
  24. II. Installation
  25. ----------------
  26.  
  27. Pour démarrer un terminal avec BYR, lancez TFPCX comme à l'accoutumé, ensuite
  28. tapez BYR sans autre argument, le programme répond:
  29.  
  30. BYR version 3.1
  31. installation en résident
  32. 73's de F5TKW
  33.  
  34. enfin, lancez normalement le programme terminal.
  35.  
  36. Voici un exemple de fichier batch que vous pourriez créer pour l'utilisation
  37. de GP (en admettant que vous êtes sur COM2):
  38.  
  39. TFPCX -PCOM2    <= installation de TFPCX
  40. BYR             <= installation de BYR
  41. GP              <= lancement de GP (ou GP286)
  42. BYR             <= désinstallation de BYR
  43. TFPCX -U        <= désinstallation de TFPCX
  44.  
  45. Vous l'avez compris, pour désinstaller BYR de la mémoire, il suffit de retaper
  46. BYR toujours sans argument.
  47.  
  48. Si vous utilisez un TNC avec TFPCR, ajoutez l'option -I:FD sur la ligne de
  49. commande de ce dernier afin de simuler TFPCX, BYR étant au départ fait pour
  50. BAYCOM.
  51.  
  52. Actuellement, BYR consomme un peu moins de 25Ko en mémoire. Si vous ne comptez
  53. pas utiliser la récupération de messages compacté, vous pouvez lancez BYR sans
  54. cette option. Dans ce cas, il consomme moins de 16Ko, ce qui fait quand même
  55. un bon tiers de mémoire de gagné. Pour supprimer la récupération compactée de
  56. BYR, il suffit de lancer ce dernier avec une ligne de commande quelconque, par
  57. exemple, tapez:
  58.   BYR A
  59. et vous gagnerez donc les 8 Ko de mémoire (en perdant donc la fonction citée
  60. plus haut).
  61.  
  62.  
  63. III. Transferts YAPP
  64. --------------------
  65.  
  66. Pour charger un fichier en mode YAPP, tout est automatique, il suffit d'agir
  67. comme si le terminal que vous utilisez incluait le YAPP. Par exemple, sur BBS
  68. type FBB, il suffit de taper la commande YGET <nom de fichier> et le
  69. chargement se fera automatiquement. Le fichier chargé se mettra dans le
  70. répertoire d'où à été lancé BYR. Voici un exemple:
  71. Vous utilisez le terminal GP, vous souhaitez que votre récupération soit
  72. stockée dans le répertoire C:\GP\SAVE et BYR se trouve dans C:\GP\BYR. Pour se
  73. faire, placez vous dans le répertoire de sauvegarde (CD \GP\SAVE) et appelez
  74. BYR (C:\GP\BYR\BYR): vous trouverez alors vos données dans C:\GP\SAVE quel que
  75. soit les changements de répertoire qui suivront l'installation de BYR.
  76.  
  77. Pour envoyer un fichier, tapez
  78. /BYR NomFich
  79. ou NomFich est le nom du fichier à envoyer avec éventuellement un chemin (le
  80. répertoire courant est pris par défaut)
  81. Voici un exemple de la façon de poser un fichier sur un BBS type FBB:
  82.  
  83. Tout d'abord connectez-vous au BBS, celui-ci répond par exemple:
  84.  
  85. (1) CONNECTED to 1:F5GJC-1
  86.  
  87. [FBB-5.15-ABFHM$]                                               ─┐
  88. Bonjour Frederic.    Voie 1 - 3 voie(s) active(s).               │
  89.                                                                  │
  90.    - 1320 messages actifs -                                      │ En-tête
  91.    - Pagination a -- ligne(s)    - Base de numérotation 196000 - │    du
  92.    - Bienvenue sur F5GJC-1 BBS Dpt. 81 -                         │   BBS
  93.                                                                  │
  94.                                                                  │
  95. Il y a 11 message(s) personnel(s) en attente.                    │
  96. 3:F5GJC>                                                        ─┘
  97. D                                               ── D pour DOS
  98.                                                 ─┐
  99. 07-Aou 21:29 FBBDOS V5.15                        │ réponse
  100.                                                  │ du BBS
  101. C:\>                                            ─┘
  102. CD F5TKW                                     ── répertoire où mettre le fichier
  103. C:\F5TKW>                                    ── réponse obtenue
  104. YPUT BYR.COM                                 ── poser le fichier BYR.COM
  105.  
  106. description du fichier, max 40 caractères :  ── entrez un commentaire
  107. Ceci n'est qu'un essai                       ── en voici un exemple
  108.  
  109. Prêt à recevoir le fichier BYR.COM avec le protocole YAPP.    ── BBS prêt
  110. /byr c:\byr.com                       ── Commande BYR pour envoyer le fichier
  111.  
  112. BYR 3.1> Envoi du fichier C:\BYR.COM  ── Réponse de BYR, le transfert commence
  113. ██████████████████████████            ── La barre d'état montre l'évolution
  114. info                                  ── Tapez INFO pour connaître l'état
  115. BYR 3.1> Envoi du fichier M:\byr.com  ─┐
  116.          2751/8319 octets              │
  117.          33% du transfert effectué     │
  118.          Durée écoulée :  0:00:33      │ Exemple de réponse obtenue
  119.          Durée restante:  0:01:08      │
  120.          Durée totale  :  0:01:41      │
  121.          Vitesse en CPS: 82           ─┘
  122.  
  123. ███████████████████████████████████████████████████████████████████████████████
  124. BYR 3.1> Fin du transfert             ─┐
  125.          Durée totale   :  0:01:37     │ Fin du transfert
  126.          Vitesse moyenne: 85 cps       │
  127.          73's de F5TKW                ─┘
  128.  
  129. Le fichier BYR.COM a été enregistré (8319 octets). ── Le BBS à enregistré
  130.  
  131. C:\F5TKW>                                          ── et vous rend la main
  132.  
  133. Pendant le transfert, vous pouvez afficher des infos en tapant INFO.
  134. Pour stopper le transfert, tapez STOP, BYR fait alors une demande d'annulation
  135. et attend la réponse. Si celle-ci ne vient pas (cela peut prendre plus d'une
  136. minute car il faut que les tampons se vident (TNC ou TFPCX)), retapez une
  137. seconde fois STOP et le transfert sera arrêté sans accusé de réception.
  138.  
  139. la commande /BYRB permet de basculer l'affichage de la barre qui montre l'état
  140. d'avancement du transfert en cours.
  141.  
  142. /BYRS active ou désactive l'émission d'une sonnerie à la fin d'un transfert
  143. (commande bascule).
  144.  
  145. l'instruction /BYRP sert à afficher ou à modifier le PacLen qui sera utilisé
  146. lors de l'émission d'un fichier. /BYRP sans argument affiche le PacLen
  147. courant. Pour passer le PacLen à 128, tapez /BYRP 128, le PacLen par défaut
  148. étant de 255.
  149.  
  150. /BYRM permet de récupérer plusieurs fichier du DOS d'un BBS type FBB de façon
  151. entièrement automatique: saisissez un fichier nommé BYR.LST contenant la liste
  152. des fichiers à charger (le fichier doit être toujours dans le répertoire de
  153. départ de BYR), connectez vous à votre BBS, passez en DOS (D), éventuellement
  154. rentrez dans le répertoire adéquat puis tapez la commande /BYRM, BYR enverra
  155. les commandes YGET automatiquement.
  156.  
  157. Depuis la version 2.4, BYR peut répondre automatiquement au mot de passe
  158. demandé par un BBS type FBB lors de la commande SYS. Celle-ci est détectée et
  159. la réponse envoyée utilise la phrase contenue dans le fichier BYR.PWD qui doit
  160. se trouver dans le répertoire de démarrage de BYR (celui où vont se mettre les
  161. fichiers récupérés). Cette fonction est utile aux SYSOPs qui font du ménage
  162. YAPP et qui utilisent un logiciel qui ne possède pas cette fonction.
  163. De plus, certains accès BBS demandent un mot de passe dès la connexion,
  164. c'est-à-dire sans commande SYS. Dans ce cas, BYR ne peut détecter la commande
  165. SYS puisque celle-ci n'est pas envoyée. La solution est de taper /SYS avant de
  166. se connecter et BYR fera quand même le travail.
  167. Si par mégarde une erreur est commise, tapez STOP pour désactiver l'attente du
  168. mot de passe.
  169.  
  170. Pour afficher de l'aide, tapez /BYRH à tout moment.
  171.  
  172.  
  173. IV. Utilisation des macro-commandes
  174. -----------------------------------
  175. Depuis la version 3.0, BYR intègre un langage de programmation de
  176. macro-commandes qui permet d'automatiser la plupart des manipulations courantes
  177. en packet. Des exemples de macro sont fournis.
  178.  
  179. pour appeler une macro, tapez /BYRC <NomMacro>
  180. exemple: /byrc mlr pour appeler la macro mlr qui se situe toujours dans le
  181. répertoire de sauvegarde.
  182.  
  183. les fichiers macro doivent être alors stockés dans le répertoire de sauvegarde
  184. de BYR (celui où vont se mettre les fichiers récupérés en YAPP).
  185.  
  186. Voici donc une description de toutes les commandes disponibles, des exemples
  187. viendront ensuite agrémenter l'énumération. Tous les noms de fichiers utilisés
  188. ne doivent pas contenir de chemin et sont lus ou écrits dans le répertoire de
  189. sauvegarde de BYR. L'emploi de majuscules ou de minuscules est indifférent.
  190.  
  191. CMD <Commande>
  192.   envoie la commande <Commande> directement au TNC (TFPCX ...). Par exemple,
  193.   pour connecter F6FBB-1, taper:
  194.   CMD C F6FBB-1
  195.  
  196. WAIT <Durée>
  197.   Attend <Durée> secondes.
  198.   pour produire une attente de 30 secondes, taper:
  199.   WAIT 30
  200.  
  201. WAIT <Heure>
  202.   Attend jusqu'à l'heure <Heure>.
  203.   Pour attendre jusqu'à 14 heures 30, taper:
  204.   WAIT 14:30
  205.   Pour attendre jusqu'à 8 heure 30 minutes et 16 secondes, taper:
  206.   WAIT 8:30:16
  207.  
  208. WAIT <Durée> FOR <Condition>
  209.   Attend <Durée> secondes que la condition <Condition> soit remplie. Si
  210.   celle-ci ne l'est pas dans le temps imparti, une erreur est produite (voir
  211.   plus bas). Dans le cas contraire, l'exécution de la macro continue sans
  212.   attendre plus longtemps. Pour la description des conditions disponibles, voir
  213.   plus bas.
  214.   Par exemple, pour attendre 1 minute une connexion qui a été demandée, taper:
  215.   WAIT 60 FOR CONNECTED
  216.   mais si la station est connectée avant, l'exécution se poursuivra à la
  217.   prochaine instruction.
  218.  
  219. WAIT <Heure> FOR <Condition>
  220.   Idem à la commande précédente, mais l'échéance de temps est une heure fixe.
  221.   Pour attendre jusqu'à 19 heures que la station distante soit déconnectée,
  222.   taper:
  223.   WAIT 19:00 FOR NOT CONNECTED
  224.  
  225. WAIT <Durée> FOR <Chaîne>
  226.   Attend <Durée> secondes que la chaîne <Chaîne> soit reçue de la part du
  227.   correspondant. Si celle-ci ne l'est pas dans le temps imparti, une erreur
  228.   est produite. Dans le cas contraire, l'exécution de la macro continue sans
  229.   plus attendre.
  230.   Pour attendre 1 minute que le prompt du BBS arrive, taper:
  231.   WAIT 60 for "F6FBB>^M"
  232.   en admettant que vous veniez de vous connecter à F6FBB-1 et que vous soyez en
  233.   mode expert, car le prompt est différent dans le cas contraire.
  234.   Voir plus bas pour la description de la structure des chaînes de caractères.
  235.  
  236. WAIT <Heure> FOR <Chaîne>
  237.   Idem à la commande précédente, mais l'échéance de temps est une heure fixe.
  238.   Pour attendre jusqu'à 20 heures 30 le prompt du BBS, taper:
  239.   WAIT 20:30 FOR "F6FBB>^M"
  240.  
  241. SEND <Chaîne>
  242.   Envoie le message <Chaîne> au correspondant.
  243.   Par exemple, si vous êtes connecté à un BBS et que vous avez reçu le prompt,
  244.   tapez:
  245.   SEND "L^M"
  246.   pour demander la liste des messages du BBS.
  247.  
  248. ECHO <Chaîne>
  249.   Envoie le message <Chaîne> vers le terminal.
  250.   Par exemple, pour envoyer la chaîne "Vous êtes connecté au serveur", tapez:
  251.   ECHO "Vous êtes connecté au serveur"
  252.   Cela permet d'envoyer des commentaires à l'utilisateur sur le déroulement de
  253.   la macro. Il est inutile de mettre le retour chariot en fin de message, car
  254.   celui-ci est automatiquement rajouté.
  255.  
  256. SENDKEYS <Touches>
  257.   Envoie <Touches> comme si elle avaient été tapées au clavier.
  258.   la description des touches est la suivante:
  259.     - une chaîne de caractères
  260.     - un nombre de 0 à 255 pour désigner directement le code ASCII
  261.     - un nombre précédé du caractère arobas (@) pour désigner des codes ASCII
  262.       étendus (voir plus bas la table des codes ASCII étendus)
  263.   il est possible d'utiliser une combinaison de ces trois solutions: vous
  264.   devez alors séparer chaque argument par une virgule (,).
  265.   exemple:
  266.     SENDKEYS @104,27,"C F6FBB-1^M"
  267.     simule l'appuie sur la touche F1, puis la touche escape et saisit le texte
  268.     C F6FBB-1 suivit d'un retour chariot.
  269.   Cette fonction permet de manipuler le terminal comme si c'est vous qui
  270.   tapiez au clavier.
  271.  
  272. SENDHEADER
  273.   Commande utilisée pour la lecture de messages compactés sur les BBS du type
  274.   FBB: envoie une commande spéciale demandant au BBS de "passer en mode
  275.   compacté". A utiliser une fois connecté au BBS.
  276.  
  277. REM texte
  278.   Cette commande est ignorée et permet de rajouter des commentaires dans la
  279.   macro.
  280.  
  281. TEXTSAVE NomFich
  282.   Entame une sauvegarde texte de toutes les informations arrivant sur la voie
  283.   et la stocke dans NomFich. Cela permet par exemple de capturer la liste des
  284.   messages d'un BBS
  285.  
  286. ENDTEXTSAVE
  287.   Stoppe une sauvegarde texte entamée avec TEXTSAVE.
  288.  
  289. BINSAVE NomFich
  290.   idem à TEXTSAVE, mais la sauvegarde est binaire, c'est-à-dire que les retours
  291.   chariots packet (caractère ASCII 13) ne seront pas convertis en retours
  292.   texte (ASCII 13 et 10). L'utilisation en est plus rare et spécifique.
  293.  
  294. ENDBINSAVE
  295.   Stoppe une sauvegarde texte entamée avec TEXTSAVE.
  296.  
  297. OPEN NomFich
  298.   Ouvre le fichier NomFich en vu d'une lecture ligne à ligne.
  299.   Pour ouvrir le fichier BYR.LST, taper:
  300.   OPEN BYR.LST
  301.  
  302. READLINE
  303.   Lit une ligne de texte du fichier ouvert avec la commande OPEN et la stocke
  304.   dans la variable ^$. Les lignes du fichiers doivent avoir une longueur
  305.   inférieure ou égale à 128 caractères.
  306.   Pour la description de la variable ^$, voir plus bas la structure des
  307.   chaînes de caractères.
  308.  
  309. READCHARS <Nombre>
  310.   Lit <Nombre> caractères dans le fichier ouvert avec la commande OPEN et les
  311.   stockent dans la variable ^$. <Nombre> doit être compris entre 1 et 128.
  312.   Pour lire 10 caractères, taper:
  313.   READCHARS 10
  314.  
  315. DELBEGIN
  316.   Efface toutes les données déjà lues dans le fichier ouvert par OPEN.
  317.   Par exemple, si vous avez programmé une macro pour envoyer une liste de
  318.   commandes au BBS, et que vous exécutiez DELBEGIN après que la commande ait
  319.   été envoyée au BBS, cela permet de mettre à jour le fichier et de reprendre
  320.   là où vous vous étiez arrêté en cas de coupure de link, d'arrêt volontaire
  321.   de la macro ou de panne d'électricité.
  322.  
  323. CLOSE
  324.   Ferme le fichier ouvert par OPEN.
  325.  
  326. DEL <NomFich>
  327.   Efface du disque le fichier <NomFich>. La commande est équivalente à celle
  328.   du DOS, si ce n'est la restriction au répertoire de sauvegarde de BYR.
  329.  
  330. BYRM
  331.   Entame une récupération multifichiers. Cette commande est équivalente à la
  332.   commande /BYRM utilisé en direct.
  333.  
  334. GOTO <Etiquette>
  335.   Continue l'exécution de la macro à partir de <Etiquette>. Une étiquette doit
  336.   commencer ne doit pas contenir d'espaces et doit se terminer par un
  337.   caractère deux-points (:).
  338.   Exemple:
  339.     .
  340.     .
  341.     .
  342.   Début:
  343.     .
  344.     .
  345.     .
  346.   GOTO Début
  347.  
  348.   La Macro fera une boucle infinie entre l'instruction Début: et GOTO Début
  349.   s'il n'y a pas d'autre branchement à l'intérieur de la boucle.
  350.  
  351. IF <Condition> <Instruction>
  352.   Si la condition <Condition> est vraie, alors l'instruction <Instruction> est
  353.   exécutée, sinon, la macro continue à l'instruction suivante.
  354.  
  355.   Exemple pour détecter une erreur:
  356.     .
  357.     .
  358.     .
  359.   IF ERROR goto Erreur
  360.     .
  361.     .
  362.     .
  363.   Erreur:
  364.   REM c'est là que se trouve les instructions qui seront exécutées si
  365.   l'instruction précédant le IF à produit une erreur.
  366.  
  367. BEEP
  368.   Emet la sonnerie de fin de transfert.
  369.  
  370. BEEP1
  371. BEEP2
  372. BEEP3
  373.   ces commandes sont similaires à BEEP, mais elles émettent respectivement une
  374.   sonnerie de type différent.
  375.  
  376. CALL <NomMacro>
  377.   Appelle ma macro <NomMacro> puis reprend l'exécution lorsque <NomMacro> est
  378.   terminée
  379.  
  380. RETURN
  381.   A utiliser dans une macro appelée par une autre: retourne dans la macro
  382.   appelante sans que la macro appelée ait été terminée. Cette commande permet
  383.   de terminer une macro appelée à n'importe quel endroit.
  384.  
  385. STOP
  386.   Arrête l'exécution de la macro.
  387.   normalement, la macro s'arrête lorsque la dernière instruction du fichier à
  388.   été exécutée. STOP permet de terminer la macro à n'importe quel endroit (en
  389.   cas d'erreur par exemple).
  390.  
  391.  
  392. Après la description de toutes les commandes, voici les instructions de
  393. condition:
  394.   ERROR: est vrai si l'instruction précédente à provoquée une erreur
  395.     Une error est produite si:
  396.       - Une durée ou une heure contenue dans une instruction WAIT est
  397.         dépassée. Exemple:
  398.          WAIT 60 FOR CONNECTED
  399.          IF ERROR GOTO Erreur
  400.            .
  401.            .
  402.            .
  403.          Erreur:
  404.            ECHO "La station ne semble pas répondre"
  405.  
  406.       - lors d'un READLINE ou d'un READCHARS, la fin du fichier lu a été
  407.         atteinte.
  408.       - lorsque le fichier ouvert avec OPEN n'existe pas.
  409.       - lorsque l'on appelle CLOSE alors qu'aucun fichier n'est ouvert.
  410.       - lorsque l'on arrête avec ENDTEXTSAVE ou ENDBINSAVE une sauvegarde qui
  411.         n'a jamais été entamée (avec TEXTSAVE ou BINSAVE).
  412.       - lorsque l'on demande l'effacement avec DEL d'un fichier inexistant.
  413.     La détection de l'erreur doit se faire immédiatement après la commande qui
  414.     aurait pu la produire, car une erreur est annulée dès l'instruction
  415.     suivante.
  416.   CONNECTED: est vrai si le canal est en mode connecté.
  417.     Par exemple, vous pouvez taper:
  418.       IF CONNECTED GOTO Connecté
  419.         .
  420.         .
  421.         .
  422.       Connecté:
  423.         ECHO "Vous êtes connecté à votre correspondant"
  424.   TX: est vrai si un transfert est actuellement en cours (YAPP émission et
  425.       réception, message compacté, mot de passe BBS)
  426.  
  427.   si vous faites précéder la condition du mot NOT, celle-ci est inversé:
  428.     IF NOT CONNECTED GOTO NonConnecté
  429.       .
  430.       .
  431.       .
  432.     NonConnecté:
  433.       ECHO "Vous n'êtes pas connecté"
  434.  
  435.  
  436. Voici maintenant la structure des chaînes de caractères:
  437.   Une chaîne de caractère commence et se termine par une guillemet ("). Entre
  438.   les deux, vous pouvez saisir n'importe quel texte dans lequel le caractère
  439.   accent circonflexe (^) joue un rôle particulier:
  440.     Si vous faites suivre un ^ par une lettre, alors c'est le caractère de
  441.       contrôle correspondant à la lettre qui sera envoyé. Par exemple, ^M
  442.       représente un passage à la ligne.
  443.     Si le ^ est suivi d'un dollar ($), ces deux caractères sont remplacés par
  444.       la ligne de texte lue par la dernière l'instruction READLINE ou par les
  445.       derniers caractères lus par l'instruction READCHARS.
  446.       Admettons que vous ayez ouvert un fichier dans lequel se trouve une
  447.         liste de noms de fichiers à récupérer, vous pouvez taper:
  448.           READLINE
  449.         Admettons que le texte TOTO.BAT ait été lu"
  450.             .
  451.             .
  452.             .
  453.           SEND "YGET ^$^M"
  454.         enverra la commande YGET TOTO.BAT suivie d'un retour chariot.
  455.       Autre exemple: le fichier que vous avez ouvert contient le texte suivant:
  456.         "Ceci est un texte de test"
  457.         les deux instructions suivantes:
  458.           READCHARS 10
  459.           ECHO "Texte lu: ^$"
  460.         donnent un affichage vers le terminal comme suit:
  461.           Texte lu: Ceci est u
  462.         Si vous réitérez les deux instructions, cela donnera:
  463.           Texte lu: n texte de
  464.  
  465.  
  466. Beaucoup de commandes possèdent une abréviation:
  467. ┌─────────────┬───────┐
  468. │ Commande    │ Abrév.│
  469. ├─────────────┼───────┤
  470. │ BINSAVE     │ BS    │
  471. │ CONNECTED   │ C     │
  472. │ DELBEGIN    │ DB    │
  473. │ ENDBINSAVE  │ EBS   │
  474. │ ENDTEXTSAVE │ ETS   │
  475. │ ERROR       │ E     │
  476. │ READCHARS   │ RC    │
  477. │ READLINE    │ RL    │
  478. │ RETURN      │ R     │
  479. │ SENDHEADER  │ SH    │
  480. │ SENDKEYS    │ SK    │
  481. │ TEXTSAVE    │ TS    │
  482. └─────────────┴───────┘
  483.  
  484.  
  485. V. Utilisation des macros livrées
  486. ---------------------------------
  487.  
  488. Plusieurs macro sont jointes avec BYR, en voici la description.
  489.  
  490. Avant d'utiliser l'une de ces macros, vous devez spécifier l'indicatif de
  491. votre BBS ainsi que la forme de son prompt (messagerie et DOS):
  492.   - Editez le fichier MCONNECT.INC et introduisez l'indicatif de votre BBS à la
  493.     ligne 2 (CMD C indicatif_BBS).
  494.   - Editez le fichier MWAITP.INC et indiquez la forme de la fin du prompt de
  495.     votre BBS. Si vous êtes en mode standard, la ligne à saisir est
  496.     généralement la suivante:
  497.       WAIT 60 FOR "X,Y,Z,?) >^M"
  498.     Par contre, si vous êtes en mode expert, le prompt change de forme et est
  499.     généralement le suivant (sauf indicatif du BBS bien sûr):
  500.       WAIT 60 FOR ":F5GJC>^M"
  501.     le ^M veut dire retour chariot (voir structure des chaînes de caractères).
  502.   - Faites la même modifications sur le fichier MWAITP1.INC:
  503.       WAIT 1 FOR "X,Y,Z,?) >^M"
  504.     ou
  505.       WAIT 1 FOR ":F5GJC>^M"
  506.   - Editez le fichier MWAITD.INC et indiquez la forme du prompt DOS de votre
  507.     BBS qui est généralement le suivant:
  508.       WAIT 60 FOR "C:\>"
  509.   La pagination du BBS doit obligatoirement être supprimée, sinon la
  510.   récupération sera bloquée (commande OP).
  511.  
  512. L'ensemble des fichier .INC sont des morceaux de macros qui sont appelés par
  513. les macros principales.
  514.  
  515. Voila, les macros sont prêtes à être utilisées avec votre BBS local. Rappel:
  516. pour appeler une macro, taper:
  517. /BYRM <NomMacro>
  518. Exemple: pour exécuter la macro MRECUP, taper (dans votre terminal bien sûr)
  519. la commande:
  520. /BYRM MRECUP
  521.  
  522.   ML: se connecte au serveur, récupère la liste des messages, la stocke dans
  523.       un fichier nommé LISTE et quitte proprement le serveur (commande B).
  524.   MLR: idem à ML, mais la liste obtenue sera dans l'ordre inverse (du message
  525.        le plus ancien au plus récent).
  526.   MR1: se connecte au serveur, lit les messages dont les numéros se trouvent
  527.        dans un fichier nommé LISTE1 et quitte proprement le serveur. Si la
  528.        connexion est interrompue, la macro se reconnecte automatiquement au
  529.        bout de 1 ou 2 minutes et reprend la récupération où elle avait été
  530.        stoppée.
  531.        voici un exemple de ce que pourrait contenir le fichier LISTE1:
  532.        R 210520
  533.        R 210542
  534.        R 210601
  535.        ...
  536.        Ce fichier peut être produit par le programme LISTE.COM. Il est
  537.        conseillé de ne mettre qu'un seul numéro de message par ligne afin
  538.        qu'en cas de coupure, seul le dernier message en cours de lecture soit
  539.        redemandé.
  540.   MR2: idem à MR1 mais utilise le contenu du fichier LISTE2
  541.   MF1: idem à MR1 mais récupère les messages en mode compacté.
  542.   MF2: idem à MR2 mais récupère les messages en mode compacté.
  543.   MRECUP: cette macro permet d'automatiser la totalité de la récupération de
  544.           messagerie sur BBS:
  545.           - Exécute la macro MLR (récupération de la liste des messages).
  546.           - Passe en DOS (à partir du terminal GP, pour d'autre logiciels, il
  547.             suffit de modifier la commande envoyée par l'instruction SENDKEYS).
  548.           - Exécute le programme LISTE avec lequel vous choisirez les messages
  549.             à lire. LISTE crée alors deux fichier LISTE1 et LISTE2 dans
  550.             lesquels se trouve la liste des messages choisis. Configurez LISTE
  551.             afin qu'il n'y ait qu'un seul numéro de message par ligne afin
  552.             qu'en cas de coupure, seul le dernier message ne soit redemandé.
  553.           - Revient sous le terminal et exécute les macros MR1 et MR2.
  554.           Pour cette macro, les fichiers LISTE.BAT, LISTE.COM et le répertoire
  555.           de sauvegarde de BYR doivent se trouver dans répertoire du terminal
  556.           (GP par exemple). Le répertoire de sauvegarde de BYR est le
  557.           répertoire à partir duquel il est lancé (celui où vont se mettre les
  558.           fichiers récupérés).
  559.   MRECUPF: idem à MRECUP mais la récupération se fera en mode compacté.
  560.   MKM: se connecte au serveur, envoie une commande KM (effacement des messages
  561.        personnels lus) et quitte proprement.
  562.   MBYRM: macro similaire à la commande /BYRM, mais en cas de coupure de link,
  563.          se reconnecte au bout de 1 ou 2 minutes et reprend le transfert
  564.          interrompu. Le fichier BYR.LST doit contenir la liste des fichiers à
  565.          récupérer en mode YAPP, chemin inclus, car au démarrage de la macro,
  566.          on se trouve sur l'origine du disque dur du BBS.
  567.  
  568.   lors de l'utilisation de MR1, MR2, MF1 ou MF2, vous pouvez interrompre la
  569.   récupération (si vous avez besoin de l'ordinateur pour d'autre occupations
  570.   temporaires par exemple): tapez STOP puis déconnectez le serveur. Le fichier
  571.   LISTE1 (ou LISTE2) contient alors la liste des messages qui n'ont pas encore
  572.   été lus. Pour reprendre, redémarrez simplement la macro interrompue.
  573.  
  574.   Lorsque BYR demande une connection (CMD C indicatif), le terminal hôte croit
  575.   qu'une station extérieure l'appelle, car ce n'est pas lui qui a initié la
  576.   connection. Les conséquences sont que le terminal émet sa sonnerie de
  577.   connection et envoie son CTEXT. Le CTEXT est alors intercépté par BYR en
  578.   tant que commande invalide (ce qui n'est pas génant). Pour éviter ce
  579.   problème, vous pouvez utiliser l'instruction SENDKEYS pour simuler l'appuie
  580.   sur les touches adéquates afin d'obtenir une demande de connection de la
  581.   part du terminal hôte. Voici un exemple pour GP, cette commande venant
  582.   remplacer la seconde ligne dans le fichier MCONNECT.INC:
  583.     SENDKEYS 27,"C F6FBB-1^M"
  584.   La connection s'effectuant sur le canal en cours, il ne faut pas sortir du
  585.   canal duquel a été appelée la macro, sinon la connection ne se fera pas sur
  586.   le bon canal.
  587.  
  588. Ceci n'est qu'un exemple de ce que peut apporter la programmation de macros,
  589. les autres idées ne tiennent qu'à votre imagination !
  590.  
  591. VI. Table des codes ASCII étendus
  592. ---------------------------------
  593.  
  594. Un tiret (-) indique que la touche (ou combinaison de touches) n'est pas un
  595. code ASCII étendu.
  596.  
  597. ┌───────────────┬─────────┬─────────┬──────┬──────┐
  598. │ Touche        │ Normale │ shiftée │ Ctrl │ ALT  │
  599. ├───────────────┼─────────┼─────────┼──────┼──────┤
  600. │ A             │    -    │    -    │  -   │ @30  │
  601. │ B             │    -    │    -    │  -   │ @48  │
  602. │ C             │    -    │    -    │  -   │ @46  │
  603. │ D             │    -    │    -    │  -   │ @32  │
  604. │ E             │    -    │    -    │  -   │ @18  │
  605. │ F             │    -    │    -    │  -   │ @33  │
  606. │ G             │    -    │    -    │  -   │ @34  │
  607. │ H             │    -    │    -    │  -   │ @35  │
  608. │ I             │    -    │    -    │  -   │ @23  │
  609. │ J             │    -    │    -    │  -   │ @36  │
  610. │ K             │    -    │    -    │  -   │ @37  │
  611. │ L             │    -    │    -    │  -   │ @38  │
  612. │ M             │    -    │    -    │  -   │ @50  │
  613. │ N             │    -    │    -    │  -   │ @49  │
  614. │ O             │    -    │    -    │  -   │ @24  │
  615. │ P             │    -    │    -    │  -   │ @25  │
  616. │ Q             │    -    │    -    │  -   │ @16  │
  617. │ R             │    -    │    -    │  -   │ @19  │
  618. │ S             │    -    │    -    │  -   │ @31  │
  619. │ T             │    -    │    -    │  -   │ @20  │
  620. │ U             │    -    │    -    │  -   │ @22  │
  621. │ V             │    -    │    -    │  -   │ @47  │
  622. │ W             │    -    │    -    │  -   │ @17  │
  623. │ X             │    -    │    -    │  -   │ @45  │
  624. │ Y             │    -    │    -    │  -   │ @21  │
  625. │ Z             │    -    │    -    │  -   │ @44  │
  626. │ F1            │   @59   │   @84   │ @94  │ @104 │
  627. │ F2            │   @60   │   @85   │ @95  │ @105 │
  628. │ F3            │   @61   │   @86   │ @96  │ @106 │
  629. │ F4            │   @62   │   @87   │ @97  │ @107 │
  630. │ F5            │   @63   │   @88   │ @98  │ @108 │
  631. │ F6            │   @64   │   @89   │ @99  │ @109 │
  632. │ F7            │   @65   │   @90   │ @100 │ @110 │
  633. │ F8            │   @66   │   @91   │ @101 │ @111 │
  634. │ F9            │   @67   │   @92   │ @102 │ @112 │
  635. │ F10           │   @68   │   @93   │ @103 │ @113 │
  636. │ F11           │   @87   │    -    │  -   │  -   │
  637. │ F12           │   @88   │    -    │  -   │  -   │
  638. │ Flèche Gauche │   @74   │    -    │ @115 │  -   │
  639. │ Flèche droite │   @77   │    -    │ @116 │  -   │
  640. │ Flèche haute  │   @72   │    -    │  -   │  -   │
  641. │ Flèche basse  │   @80   │    -    │  -   │  -   │
  642. │ Début         │   @71   │    -    │ @119 │  -   │
  643. │ Fin           │   @79   │    -    │ @117 │  -   │
  644. │ Page précéd.  │   @73   │    -    │ @132 │  -   │
  645. │ Page suivante │   @81   │    -    │ @118 │  -   │
  646. │ Supprimer     │   @83   │    -    │  -   │  -   │
  647. │ Insérer       │   @82   │    -    │  -   │  -   │
  648. │ 1             │    -    │    -    │  -   │ @120 │
  649. │ 2             │    -    │    -    │  -   │ @121 │
  650. │ 3             │    -    │    -    │  -   │ @122 │
  651. │ 4             │    -    │    -    │  -   │ @123 │
  652. │ 5             │    -    │    -    │  -   │ @124 │
  653. │ 6             │    -    │    -    │  -   │ @125 │
  654. │ 7             │    -    │    -    │  -   │ @126 │
  655. │ 8             │    -    │    -    │  -   │ @127 │
  656. │ 9             │    -    │    -    │  -   │ @128 │
  657. │ Imprime Ecran │    -    │    -    │ @114 │  -   │
  658. └───────────────┴─────────┴─────────┴──────┴──────┘
  659.  
  660.  
  661.  
  662. bon trafic !
  663.  
  664. 73's QRO de F5TKW @ F6FBB.FMLR.FRA.EU
  665.  
  666.